Merchants who submit their request with a TransactionType "02" , will have to perform an additional step to finalise the settlement of the transaction. A pre–authorised transaction can be settled in one of the two following ways:
If this Settle step is not called for some reason (e.g. purchase cannot be fulfilled), then the transaction should be cancelled in order to release those funds from the customer's credit card (see 3.13 Cancel Pre-Auth API).
To perform a manual settlement do the following:
A transaction can also be settled by making a call to the Vodacom Payment Gateway as follows: The API payload can be sent as JSON.
| Field Name (Case–Sensitive) |
Type(max length) | Required MandatoryOptional |
Description |
|---|---|---|---|
| Username ^ | String | M | Merchant Technical users VPG account username. |
| Password ^ | String | M | Merchant Technical users VPG account password. |
| Destination ^ | String | M | Name of function being invoked (in this case should be set to SETTLE) |
| TransactionID | String | M | Unique value to identify a transaction. Returned by Vodacom Payment Gateway on the postback message |
| Field Name (Case–Sensitive) |
Description |
|---|---|
| Code | See 4.4 Appendix D: Bank Response Codes |
| Message | Description of response |
| TransactionID | Unique value to identify a transaction. Returned by Vodacom Payment Gateway on the postback message |
| URL Type | URL Value |
|---|---|
| API: Test/QA ^ | https://qa.vodacompaymentgateway.co.za/Payserver/Service/Execute |
| API: Live/PROD ^ | https://psp.vodacompaymentgateway.co.za/Payserver/Service/Execute |
